home *** CD-ROM | disk | FTP | other *** search
/ JCSM Shareware Collection 1993 November / JCSM Shareware Collection - 1993-11.iso / cl240 / mlrdiz10.lzh / DIZZE.TXT < prev    next >
Text File  |  1993-08-01  |  13KB  |  250 lines
  1.  
  2.                                    My Little Realm
  3.  
  4.                                DizzE (The DIZ Editor)
  5.  
  6.                                      Version 1.0
  7.           ____________________________________________________________________
  8.  
  9.                                        Important
  10.  
  11.           My Little Realm's DizzE (The DIZ Editor) is protected by copyright.
  12.           It is not freeware, and it is not in the public domain.  This 
  13.           version of DizzE is Shareware.
  14.  
  15.           Feel free to try DizzE for 60 days to make sure it works well on
  16.           your system and that it functions the way you want.  If you decide
  17.           to keep DizzE after that, please fill in the order form found in
  18.           REGISTER.TXT and send it in with your remittance.
  19.  
  20.           DizzE requires 89 Kb of disk space.  It can be run from a floppy or
  21.           a hard disk.  DizzE should run on any type of IBM compatible PC
  22.           with DOS version 2.x or later.
  23.           ____________________________________________________________________
  24.  
  25.                                Introduction/Overview
  26.  
  27.           DizzE allows you to perform the mundane task of DIZ editing with
  28.           alacrity.  DizzE checks for: 
  29.  
  30.                1  The separator (minus sign/hyphen)
  31.                2  Number of lines in the file (won't let you exceed ten)
  32.  
  33.           The separator must appear in the first two lines, or DizzE will
  34.           notify you that it is missing or misplaced.  You may bypass this 
  35.           safety check to save a DIZ file without the requisite separator.
  36.  
  37.           You can delete a DIZ file by loading it into DizzE, viewing it to
  38.           verify that it is indeed the one you want to delete, deleting all
  39.           of its lines with block-delete, and exiting the editor.  DizzE
  40.           will tell you that you have no lines of text, and it will ask if 
  41.           you wish to delete the existing file.  Reply yes.
  42.  
  43.           If you want to really churn out the DIZ files, call up one of your
  44.           best works of art, make the necessary changes, and save it to the
  45.           appropriate program's directory.  Then immediately go back into 
  46.           the editor, make more changes and save that version to another 
  47.           program's directory, and so on.
  48.  
  49.           I suggest you put DizzE in its own directory (like DIZEDIT) and 
  50.           simply call it from whatever directory you're working in at the 
  51.           time you need it.  If you are lacking hard disk space, put DizzE
  52.           on a floppy and call it up whenever you need it.  DizzE can save
  53.           files to any legitimate drive.
  54.  
  55.           Note:  The bottom line on the screen is called the Escape Line.
  56.           It will keep you apprised of the escape key's function at any
  57.           point during the operation of the program.
  58.           ____________________________________________________________________
  59.  
  60.                                    Program Specifics
  61.  
  62.           - Creating or loading a file.
  63.  
  64.           The Create/Load window.    
  65.               ___________________________________________________________
  66.              |                                                           |
  67.              |    1 Create file     2 Load file        3 Exit program    | 
  68.              |___________________________________________________________|
  69.  
  70.           When you start DizzE, you're placed in the Create/Load window.  You
  71.           can either load an existing file or leap right into the editor.
  72.           
  73.           Loading a file.
  74.           If you select Load File, Dizze will ask for a path.  If the path is
  75.           legitimate, but the file does not exist, DizzE will assume you are 
  76.           creating a new file with the path you gave it.  You must give DizzE
  77.           the complete path, but you need not enter the filename which, of 
  78.           course, remains a constant.  After you've entered the path, you're 
  79.           placed in the editor.
  80.  
  81.           You can load an existing file from one directory, modify it to meet
  82.           the needs of another program and save it to the other program's 
  83.           directory.  This boilerplate production method speeds document 
  84.           creation time considerably.
  85.  
  86.           Creating a file.
  87.           If you select the option Create File, you'll be placed in the 
  88.           editor immediately.  Let your purple prose flow.
  89.  
  90.           Exiting the editor.
  91.           The only key that gets you out of the editor properly is the
  92.           escape key.  When you've finished your literary showpiece, press 
  93.           <esc> to exit the editor.  You'll then be placed in the Save/Print 
  94.           window which is described below.
  95.  
  96.           After you exit the editor, DizzE checks for the separator.  It must
  97.           appear in the first two lines.  [Note:  Many BBS's recommend that
  98.           you put the title in uppercase, followed by the version number and
  99.           then the hyphen.]
  100.  
  101.           Sample editor screen.
  102.  
  103.                        1     MY LITTLE REALM'S DIZZE V1.0 <ASP> - This
  104.                        2     is the DIZ editor you've been waiting for!
  105.                        3     Hark the herald angels sing and all that
  106.                        4     jazz.  Baby it's cold outside.  What's it
  107.                        5     all about, Alfie?  Where were you when I
  108.                        6     needed you, where were you when I wanted 
  109.                        7     you?  In my midnight confessions, when I
  110.                        8     tell all the world that I love you.  
  111.                        9     Cherish is a word I use to describe all the
  112.                       10     feeling that I have hiding here for you
  113.               ---     11     inside.  Can't you see I love you, please
  114.                |      12     don't break my heart in two, that's not 
  115.                |      13     hard to do, 'cause I don't have a wooden
  116.                |      14     heart.  I should have known, you bid me
  117.               ---     15     farewell, there's a lesson to be learned
  118.           
  119.           You will notice that the editor allows fifteen lines of text even 
  120.           though a FILE_ID.DIZ file may only have ten.  The reason for this 
  121.           is to permit liberal use of the blocking and copying ability of the
  122.           editor, allowing you to cut and paste with relative abandon.  After
  123.           you've got the wording just right, it's up to you to delete the 
  124.           excess verbiage in the remaining lines.
  125.  
  126.           If you don't delete the remaining lines, DizzE will notify you that
  127.           there are more than ten lines of text in your edit field, and it 
  128.           will ask you what you want done with them.
  129.  
  130.                   ___________________________________________________
  131.                  |                                                   |
  132.                  |     You have more than ten lines of text.         |
  133.                  |     1  Return to editor      2  Delete excess     |
  134.                  |___________________________________________________|
  135.  
  136.  
  137.           Select 1 or R to go back to the editor to tidy up the file 
  138.           yourself, or if the top ten lines are perfect, choose 2 or D to 
  139.           erase lines 11 through 15.  [Note:  <esc> also puts you back in the
  140.           editor at this juncture.]
  141.  
  142.           If you select Create File from the Create/Load window and exit the 
  143.           editor leaving the edit field blank, you'll be returned to the 
  144.           Create/Load window automatically.  If you load an existing file, 
  145.           delete all of the text, and exit the editor, you'll be shown the 
  146.           following message:
  147.  
  148.                      __________________________________________ 
  149.                     |                                          |
  150.                     |     Working on C:\TESTING\FILE_ID.DIZ.   |
  151.                     |     Your edit field is empty.            |
  152.                     |     Delete existing file?  <Y>  <N>      |
  153.                     |__________________________________________|
  154.  
  155.  
  156.           Press <N> or <esc> to avoid deleting the file.  To effect the
  157.           delete, press <Y>.
  158.  
  159.           Once you've created your objet d'art, you're placed in the 
  160.           Save/Print window.
  161.           ____________________________________________________________________
  162.  
  163.           - Saving and printing files.
  164.  
  165.           The Save/Print window.    
  166.               ___________________________________________________________
  167.              |                                                           |
  168.              |    1 Save file      2 Print file      3 Exit Save/Print   |
  169.              |___________________________________________________________|
  170.  
  171.  
  172.           Whenever you exit the editor with text in it, DizzE displays the
  173.           Save/Print window shown above.  If you select Exit Save/Print 
  174.           before you save the file (by pressing <3> or <E>) or by pressing 
  175.           <esc>, DizzE will tell you that you have not saved the file and 
  176.           will display the following prompt:
  177.  
  178.                    ____________________________________________________    
  179.                   |                                                    |
  180.                   |   C:\TESTING\FILE_ID.DIZ not saved.                |
  181.                   |   1  Editor     2  Save file    3  Confirm exit    |
  182.                   |____________________________________________________|
  183.  
  184.  
  185.           Selecting 1 or E will put you back in the editor, and 2 or S will 
  186.           put you in the Save File function.  Choosing 3 or C confirms your 
  187.           desire to exit the Save/Print function without saving the file, and
  188.           <esc> will return you to the Save/Print window.
  189.  
  190.           Saving your files.
  191.           When you choose Save File either in the Save/Print window or in 
  192.           the warning prompt, DizzE tells you the current path\filename and 
  193.           asks how you want it saved, like so:
  194.  
  195.                      ___________________________________________ 
  196.                     |                                           |
  197.                     |     Working on C:\TESTING\FILE_ID.DIZ.    |
  198.                     |     Save as:  C:\TESTING\FILE_ID.DIZ      |
  199.                     |___________________________________________|
  200.  
  201.  
  202.           If you want to send it off someplace else (like a floppy disk),
  203.           make the appropriate changes in the Save As line and press <enter>.
  204.  
  205.           If the target path is different from the original path and there is
  206.           an existing file at the target location, DizzE will warn you of the
  207.           situation.
  208.  
  209.                    ____________________________________________________ 
  210.                   |                                                    |
  211.                   |   B:\FILE_ID.DIZ already exists.                   |
  212.                   |   1  Overwrite     2  Reenter path    3  Cancel    |
  213.                   |____________________________________________________|
  214.  
  215.  
  216.           Select 3 or C (or press <esc>) to return to the Save/Print window.
  217.           Select 1 or O to overwrite the existing file, and, 2 or R allows
  218.           you to reenter the FILE_ID.DIZ path.
  219.  
  220.           Printing your masterpieces.
  221.           You can print your FILE_ID.DIZ files in any of three page layouts:
  222.           Normal, Top Center, and Dead Center.  Normal printout puts the 
  223.           text in the top left corner of your page.  Top Center puts it where
  224.           you'd imagine, and Dead Center puts the text in the approximate
  225.           center (vertically and horizontally) of your page.
  226.           ____________________________________________________________________
  227.  
  228.           - About the editor.
  229.  
  230.           When in the editor, press <F1> to review the keys needed to block 
  231.           text, copy, delete, and so on.  It's fairly standard:  use 
  232.           <shift> + a directional key to block text; <ctrl> + <insert> to 
  233.           capture text to the buffer and <shift> + <insert> to insert 
  234.           buffered material into the text field.
  235.  
  236.           Note:  For anyone interested, the editor comes from Crescent 
  237.           Software's QuickPak Professional library.
  238.           ____________________________________________________________________
  239.  
  240.                               John L. Salisbury
  241.                               My Little Realm Enterprises
  242.                               22 Church Street #103, Suite 376
  243.                               Ramsey, New Jersey  07446
  244.                               (201) 529-8318
  245.                               CIS # 70761,2175
  246.  
  247.           DizzE (The DIZ Editor) copyright 1993 John L. Salisbury
  248.           All rights reserved.
  249.           ____________________________________________________________________
  250.